home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Franz PD / Franz PD Disk #093 (1990-10)(Amiga User Group Deutschland e.V.).zip / Franz PD Disk #093 (1990-10)(Amiga User Group Deutschland e.V.).adf / Manual / Texte / CoreWars1.1 / CoreWars1.1
Text File  |  1990-09-11  |  10KB  |  255 lines
  1.  
  2. --VB0
  3. --OZ1 11 topaz.font
  4. --OZ2 18 Bocklin.font
  5. --OZ3 27 bocklin.font
  6. --DF titelb
  7. --FF31
  8. --ZS2
  9. --SA0
  10. --PA
  11. --SA1
  12. --ZS0
  13. --FF21
  14. DEFEND
  15. --DF titelc
  16. --FF31
  17. --ZS1
  18. --SA0
  19. --PA
  20. --SA1
  21. --ZS0
  22. --FF21
  23. DEFEND
  24. --DF titelchen
  25. --FF31
  26. --ZS0
  27. --PA
  28. --ZS0
  29. --FF21
  30. DEFEND
  31. --DF climode
  32. --FF00
  33. --PA
  34. --FF21
  35. DEFEND
  36. --PI -02 -02 pinsel/Unicorngross
  37.  
  38. --ZS3
  39. --SA0
  40. --FF31
  41.            Kapitel 1.
  42.            Einführung
  43. --ZS0
  44. --FF21
  45. --SA1
  46.  
  47.  
  48. --FF31
  49. --ZS3
  50. --SA0
  51. 1.1  Installieren und Starten
  52. --SA1
  53. --ZS0
  54. --FF21
  55.  
  56. --titelb
  57. 1.1.1  Installieren auf Diskette
  58. Grundsätzlich  gibt  es  zwei  Möglichkeiten,  CoreWars  auf  einem Amiga mit
  59. Diskettenlaufwerk(en)  zu  installieren.   Die Erste besteht darin, den Amiga
  60. mit  der  startfähigen, an eingetragene Benützer versandten CoreWars-Diskette
  61. aufzustarten,  was  auf  jedem  Amiga  Modell funktioniert.  Weil das gesamte
  62. CoreWars-System  mit  der  Anleitung  jedoch  über  drei Viertel der Diskette
  63. belegt,  wird  diese  bald  einmal  voll  sein.   Dann ist es empfehlenswert,
  64. CoreWars  auf  zwei  Disketten  zu  verteilen:  Die eine enthält das Programm
  65. CoreWars   mit   den   Konfigurationsdateien,   der   Anleitung  und  einigen
  66. CLI-Befehlen  und ist startfähig.  Auf der zweiten Diskette befinden sich die
  67. Kampfprogramme  und  das  Hilfsprogramm  `View',  so  dass  für  die  eigenen
  68. Kampfprogramme  fast  eine  ganze Diskette zur Verfügung steht.  Es folgt nun
  69. eine   Liste   der   Programme   und   Dateien,  die  auf  der  startfähigen
  70. CoreWars-Diskette vorhanden sein müssen:
  71.  
  72. --FF00
  73. c (dir)
  74.   Run                            Set
  75.   SetMap                         VIEW
  76. l (dir)
  77.   Disk-Validator                 Ram-Handler
  78. devs (dir)
  79.      keymaps (dir)
  80.        ch1
  81.      printers (dir)
  82.        generic
  83.   mountlist                      printer.device
  84.   system-configuration
  85. s (dir)
  86.   Startup-Sequence
  87. t (dir)
  88. libs (dir)
  89.   arp.library                    icon.library
  90. CoreWars                       CoreWars.info
  91. cw_config                      cw_editmenu
  92. cw_editor                      cw_mainmenu
  93. cw_text
  94. --FF21
  95.  
  96. --titelchen
  97. c
  98. Hier  befinden sich alle Befehle, die durch ein CLI-Fenster aufgerufen werden
  99. können.   Die  vorgeschlagenen  vier  Befehle sind nur teilweise nötig, siehe
  100. dazu `Environment Variablen' im dritten Kapitel sowie den folgenden Abschnitt
  101. über Tastaturbelegungen.  `View' ist ein Textanzeigeprogramm, dessen Name als
  102. Eintrag  im DEFAULT TOOL Feld der von CoreWars erzeugten Icons voreingestellt
  103. ist.   Mehr  Informationen  dazu  befinden  sich ebenfalls im dritten Kapitel
  104. unter `Automatische Icons'.
  105.  
  106. --titelchen
  107. devs/keymaps
  108. Dieses  Verzeichnis  enthält  den  Belegungsplan  der  Tastatur.   Bei  einer
  109. USA-Tastatur  kann  dieses  Verzeichnis weggelassen werden, bei allen anderen
  110. Tastaturen wird im Verzeichnis `devs/keymaps' der entsprechende Belegungsplan
  111. stehen,  z.   B.   `ch1'  oder  `d'.   In  der  `Startup-Sequence'  muss  die
  112. Tastaturbelegung  mit  dem  CLI-Befehl `SetMap Name' aufgerufen werden, wobei
  113. `Name' der Name des Belegungsplanes ist.
  114.  
  115. --titelchen
  116. devs/printers und devs/printer.device
  117. Um  im  Editor  und  während  eines Turniers von den Druckfunktionen Gebrauch
  118. machen  zu  können,  müssen  im  Verzeichnis  `devs/printers'  ein  dem ange-
  119. schlossenen  Drucker  entsprechender Druckertreiber und im Verzeichnis `devs'
  120. die  Datei `printer.device' vorhanden sein.  Beide können weggelassen werden,
  121. wenn kein Drucker angesprochen werden soll.
  122.  
  123. --titelchen
  124. l/Ram-Handler
  125. Ohne diese Datei kann die RAM-Disk nicht verwendet werden.  Die RAM-Disk wird
  126. teilweise vom Programm CoreWars selbst angesprochen, diese Datei muss deshalb
  127. immer vorhanden sein.
  128.  
  129. --titelchen
  130. s/Startup-Sequence
  131. Eine  Kommandoprozedur,  die  beim  Aufstarten  mit  der Diskette automatisch
  132. ausgeführt wird.  Sie bietet sich an, um CoreWars gleich mit dem Startvorgang
  133. des  Amiga aufzurufen, was mit der folgenden Zeile geschieht, die am Ende der
  134. `Startup-Sequence',  jedoch  noch  vor der Zeile mit dem Befehl `EndCLI' z.B.
  135. mit Hilfe des CoreWars-Editors eingefügt werden kann:
  136.  
  137. --climode
  138. Run :CoreWars
  139.  
  140. --titelchen
  141. libs/arp.library
  142. Eine   inzwischen  recht  verbreitete  Funktionsbibliothek,  die  von  vielen
  143. Programmen  benötigt  wird.   Unter  Anderem  stammt  die Dateiauswahlbox aus
  144. dieser Bibliothek.
  145.  
  146. --titelchen
  147. libs/icon.library
  148. Wird  zur automatischen Erzeugung von Icons für Kampfprogramme benötigt.  Für
  149. CoreWars sind beide Bibliotheken wichtig, der Programmstart wird abgebrochen,
  150. wenn eine der beiden Dateien nicht vorhanden ist.
  151.  
  152. --titelchen
  153. CoreWars und  CoreWars.info
  154. Das Programm CoreWars und das dazugehörende Icon.  Die TOOL TYPES Einträge in
  155. diesem  Icon enthalten ein Beispiel zur Anwendung der Kommandozeilenargumente
  156. von  der  Workbench  aus.  Weitere Informationen zu den möglichen Befehlen in
  157. diesen  Einträgen  befinden  sich  im dritten Kapitel unter `Workbench'.  Das
  158. sich   beim   Programmstart   über   die   Workbench   automatisch   öffnende
  159. Ausgabefenster  kann  unterdrückt werden, indem der Eintrag `WINDOW=[...]' in
  160. den TOOL TYPES Feldern des CoreWars-Icons mit Hilfe des Workbenchmenüs `Info'
  161. gelöscht wird.
  162.  
  163. Die  Dateien  im  Hauptverzeichnis der Diskette, die mit `cw_' beginnen, sind
  164. allesamt  Einstellungsdateien für CoreWars.  Der Benützer des Programmes kann
  165. sich   so   seine   eigene   CoreWars-Entwicklungsumgebung   einrichten   und
  166. anschliessend  in diese Dateien abspeichern.  Wirklich notwendig für CoreWars
  167. sind   dabei   jedoch   nur   die   beiden  Menüdateien,  `cw_mainmenu'  und
  168. `cw_editmenu'.  Die Bedeutungen der einzelnen Einstellungsdateien sind:
  169.  
  170. cw_config   - Konfigurationsdatei.
  171. cw_editor   - Editorkonfigurationsdatei.
  172. cw_text     - Programmtexte, Titel, Fehlermeldungen, etc.
  173. cw_mainmenu - Hauptmenüdatei.
  174. cw_editmenu - Editormenüdatei.
  175.  
  176. Der  gesamte  Themenkreis  der  Konfigurierung  von  CoreWars wird im dritten
  177. Kapitel  unter  dem  Abschnitt `Konfigurierung' ausführlich dargestellt.  Für
  178. erste  Versuche  genügt  es  vollauf,  die  fünf Einstellungsdateien in ihrem
  179. aktuellen  Zustand  zu  belassen  und sich zuerst mit den Hauptfunktionen von
  180. CoreWars auseinanderzusetzen.
  181.  
  182. Für  den  Betrieb  von CoreWars ist es sinnvoll, einige weitere Verzeichnisse
  183. auf der Startdiskette oder wie eingangs beschrieben auf einer zweiten, leeren
  184. Diskette  einzurichten.   Wenn  die  Verzeichnisse auf einer zweiten Diskette
  185. angelegt  werden,  muss  auf  dieser  zusätzlich  ein Verzeichnis `c' mit dem
  186. Programm `View' vorhanden sein, weil sonst die Kampfprogramme nicht mit einem
  187. Doppelklick  auf  deren Icon über die Workbench angesehen werden können.  Die
  188. vorgeschlagenen Verzeichnisse sind:
  189.  
  190. --FF00
  191. c (dir)
  192.   View
  193. Manual (dir)
  194.   Anleitung Deutsch und Englisch zu CoreWars
  195. Programme (dir)
  196.   Assemblierte Kampfprogramme
  197. Redcode (dir)
  198.   Quelltexte der Kampfprogramme
  199. Text (dir)
  200.   Protokolldateien
  201. Turnier (dir)
  202.   Turnierdateien
  203. --FF21
  204.  
  205. Die  an  eingetragene  Benützer  versandte  CoreWars-Diskette,  auf  der  das
  206. Programm  veröffentlicht  wird, enthält alle Verzeichnisse auf einer Diskette
  207. und  ist  deshalb zu mehr als drei Viertel voll.  Mit den oben gegebenen Tips
  208. kann  diese  Diskette  soweit  `zusammengelöscht'  werden,  dass  sich  damit
  209. vernünftig  arbeiten  lässt.  Wie Dateien gelöscht, Verzeichnisse erzeugt und
  210. der  Inhalt  von  Disketten  angesehen werden kann, ist in [5] auf den Seiten
  211. 2-9, 2-13 und 2-15 beschrieben.  Allgemeines zur Bedienung des Amiga kann aus
  212. [4] und dem ersten Kapitel von [5] entnommen werden.
  213.  
  214. --titelb
  215. 1.1.2  Installieren auf Festplatte
  216. Weil  sich  die  Struktur  und der Aufbau einer Festplatte bei jedem Benützer
  217. wieder  sehr  stark  unterscheidet,  können  an  dieser Stelle nur allgemeine
  218. Richtlinien zur Installierung von CoreWars auf der Festplatte gegeben werden.
  219. Eine  Möglichkeit  besteht  darin,  ein  Verzeichnis  `CoreWars'  irgendwo im
  220. Verzeichnisbaum  der  Platte  einzurichten  und  alle für CoreWars relevanten
  221. Dateien  in diesem Verzeichnis abzulegen.  Der Aufbau des Verzeichnisses kann
  222. dann den oben vorgeschlagenen Diskettenstrukturen entsprechen, natürlich ohne
  223. die zum Aufstarten des Amiga notwendigen Dateien (`devs', `c', `libs', etc.).
  224. Eine  weitere Möglichkeit ist die Separierung des Programmes CoreWars von den
  225. benötigten  Einstellungsdateien  und den Kampfprogrammen, indem z.  B.  Core-
  226. Wars   im   `c:'-Verzeichnis   der  Festplatte,  die  Einstellungsdateien  im
  227. `s:'-Verzeichnis   und  die  Kampfprogramme  auf  Diskette  abgelegt  werden.
  228. CoreWars ist vollständig vom Benützer konfigurierbar, das bezieht sich sowohl
  229. auf  alle Suchpfade der Einstellungsdateien als auch auf die voreingestellten
  230. Verzeichnisse  für  Kampfprogramme,  Quelltexte,  Turnierdateien und Anderes.
  231. Darüberhinaus  können  mit  sogenannten  Environment  Variablen  und  Komman-
  232. dozeilenargumente (drittes Kapitel, Abschnitt `Optionen') die Aufenthaltsorte
  233. der Einstellungsdateien individuell angegeben werden.
  234.  
  235. --titelb
  236. 1.1.3  Starten des Programmes
  237. CoreWars  wird entweder durch einen Doppelklick mit der Maus auf sein Icon im
  238. Workbench  Bildschirm,  durch eine Kommandozeile in einem CLI-Fenster ähnlich
  239. den folgenden
  240.  
  241. --FF00
  242. 1> Run CoreWars:CoreWars
  243. 1> Run c:CoreWars
  244. 1> Run CoreWars
  245. 1> CoreWars
  246. --FF21
  247.  
  248. oder schliesslich durch Aufstarten des Amiga mit der ursprünglichen CoreWars-
  249. Diskette  gestartet  (im  letzten Fall mit Hilfe der `Startup-Sequence').  Je
  250. nach  Art des Aufstartens stehen verschiedene Möglichkeiten zur Uebergabe von
  251. Argumenten  zur Verfügung:  Wird CoreWars von der Workbench gestartet, können
  252. im  Icon  selbst  Argumente  als Einträge in den TOOL TYPES Feldern übergeben
  253. werden, beim Start aus dem CLI werden Kommandozeilenargumente verwendet.
  254.  
  255.